home *** CD-ROM | disk | FTP | other *** search
-
-
-
- TTTTccccllll____CCCCrrrreeeeaaaatttteeeeTTTTrrrraaaacccceeee((((3333)))) TTTTccccllll (((( )))) TTTTccccllll____CCCCrrrreeeeaaaatttteeeeTTTTrrrraaaacccceeee((((3333))))
-
-
-
- _________________________________________________________________
-
- NNNNAAAAMMMMEEEE
- Tcl_CreateTrace, Tcl_DeleteTrace - arrange for command
- execution to be traced
-
- SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
- ####iiiinnnncccclllluuuuddddeeee <<<<ttttccccllll....hhhh>>>>
-
- Tcl_Trace
- TTTTccccllll____CCCCrrrreeeeaaaatttteeeeTTTTrrrraaaacccceeee(_i_n_t_e_r_p, _l_e_v_e_l, _p_r_o_c, _c_l_i_e_n_t_D_a_t_a)
-
- TTTTccccllll____DDDDeeeelllleeeetttteeeeTTTTrrrraaaacccceeee(_i_n_t_e_r_p, _t_r_a_c_e)
-
- AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
- Tcl_Interp *_i_n_t_e_r_p (in) Interpreter
- containing
- command to be
- traced or
- untraced.
-
- int _l_e_v_e_l (in) Only commands
- at or below
- this nesting
- level will be
- traced. 1
- means top-
- level commands
- only, 2 means
- top-level
- commands or
- those that are
- invoked as
- immediate
- consequences
- of executing
- top-level
- commands
- (procedure
- bodies,
- bracketed
- commands,
- etc.) and so
- on.
-
- Tcl_CmdTraceProc *_p_r_o_c (in) Procedure to
- call for each
- command that's
- executed. See
- below for
- details on the
- calling
-
-
-
- Page 1 (printed 7/10/95)
-
-
-
-
-
-
- TTTTccccllll____CCCCrrrreeeeaaaatttteeeeTTTTrrrraaaacccceeee((((3333)))) TTTTccccllll (((( )))) TTTTccccllll____CCCCrrrreeeeaaaatttteeeeTTTTrrrraaaacccceeee((((3333))))
-
-
-
- sequence.
-
- ClientData _c_l_i_e_n_t_D_a_t_a (in) Arbitrary
- one-word value
- to pass to
- _p_r_o_c.
-
- Tcl_Trace _t_r_a_c_e (in) Token for
- trace to be
- removed
- (return value
- from previous
- call to
- TTTTccccllll____CCCCrrrreeeeaaaatttteeeeTTTTrrrraaaacccceeee).
- _________________________________________________________________
-
-
- DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
- TTTTccccllll____CCCCrrrreeeeaaaatttteeeeTTTTrrrraaaacccceeee arranges for command tracing. From now on,
- _p_r_o_c will be invoked before Tcl calls command procedures to
- process commands in _i_n_t_e_r_p. The return value from
- TTTTccccllll____CCCCrrrreeeeaaaatttteeeeTTTTrrrraaaacccceeee is a token for the trace, which may be
- passed to TTTTccccllll____DDDDeeeelllleeeetttteeeeTTTTrrrraaaacccceeee to remove the trace. There may be
- many traces in effect simultaneously for the same command
- interpreter.
-
- _P_r_o_c should have arguments and result that match the type
- TTTTccccllll____CCCCmmmmddddTTTTrrrraaaacccceeeePPPPrrrroooocccc:
-
- typedef void Tcl_CmdTraceProc(
- ClientData _c_l_i_e_n_t_D_a_t_a,
- Tcl_Interp *_i_n_t_e_r_p,
- int _l_e_v_e_l,
- char *_c_o_m_m_a_n_d,
- Tcl_CmdProc *_c_m_d_P_r_o_c,
- ClientData _c_m_d_C_l_i_e_n_t_D_a_t_a,
- int _a_r_g_c,
- char *_a_r_g_v[]));
-
- The _c_l_i_e_n_t_D_a_t_a and _i_n_t_e_r_p parameters are copies of the
- corresponding arguments given to TTTTccccllll____CCCCrrrreeeeaaaatttteeeeTTTTrrrraaaacccceeee.
- _C_l_i_e_n_t_D_a_t_a typically points to an application-specific data
- structure that describes what to do when _p_r_o_c is invoked.
- _L_e_v_e_l gives the nesting level of the command (1 for top-
- level commands passed to TTTTccccllll____EEEEvvvvaaaallll by the application, 2 for
- the next-level commands passed to TTTTccccllll____EEEEvvvvaaaallll as part of
- parsing or interpreting level-1 commands, and so on).
- _C_o_m_m_a_n_d points to a string containing the text of the
- command, before any argument substitution. _C_m_d_P_r_o_c contains
- the address of the command procedure that will be called to
- process the command (i.e. the _p_r_o_c argument of some previous
- call to TTTTccccllll____CCCCrrrreeeeaaaatttteeeeCCCCoooommmmmmmmaaaannnndddd) and _c_m_d_C_l_i_e_n_t_D_a_t_a contains the
-
-
-
- Page 2 (printed 7/10/95)
-
-
-
-
-
-
- TTTTccccllll____CCCCrrrreeeeaaaatttteeeeTTTTrrrraaaacccceeee((((3333)))) TTTTccccllll (((( )))) TTTTccccllll____CCCCrrrreeeeaaaatttteeeeTTTTrrrraaaacccceeee((((3333))))
-
-
-
- associated client data for _c_m_d_P_r_o_c (the _c_l_i_e_n_t_D_a_t_a value
- passed to TTTTccccllll____CCCCrrrreeeeaaaatttteeeeCCCCoooommmmmmmmaaaannnndddd). _A_r_g_c and _a_r_g_v give the final
- argument information that will be passed to _c_m_d_P_r_o_c, after
- command, variable, and backslash substitution. _P_r_o_c must
- not modify the _c_o_m_m_a_n_d or _a_r_g_v strings.
-
- Tracing will only occur for commands at nesting level less
- than or equal to the _l_e_v_e_l parameter (i.e. the _l_e_v_e_l
- parameter to _p_r_o_c will always be less than or equal to the
- _l_e_v_e_l parameter to TTTTccccllll____CCCCrrrreeeeaaaatttteeeeTTTTrrrraaaacccceeee).
-
- Calls to _p_r_o_c will be made by the Tcl parser immediately
- before it calls the command procedure for the command
- (_c_m_d_P_r_o_c). This occurs after argument parsing and
- substitution, so tracing for substituted commands occurs
- before tracing of the commands containing the substitutions.
- If there is a syntax error in a command, or if there is no
- command procedure associated with a command name, then no
- tracing will occur for that command. If a string passed to
- Tcl_Eval contains multiple commands (bracketed, or on
- different lines) then multiple calls to _p_r_o_c will occur, one
- for each command. The _c_o_m_m_a_n_d string for each of these
- trace calls will reflect only a single command, not the
- entire string passed to Tcl_Eval.
-
- TTTTccccllll____DDDDeeeelllleeeetttteeeeTTTTrrrraaaacccceeee removes a trace, so that no future calls
- will be made to the procedure associated with the trace.
- After TTTTccccllll____DDDDeeeelllleeeetttteeeeTTTTrrrraaaacccceeee returns, the caller should never again
- use the _t_r_a_c_e token.
-
-
- KKKKEEEEYYYYWWWWOOOORRRRDDDDSSSS
- command, create, delete, interpreter, trace
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- Page 3 (printed 7/10/95)
-
-
-
-
